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PREFACE 


The Agriculture and Resources Inventory Surveys Through Aerospace Remote 
Sensing is a 6-year program of research, development, evaluation, and appli- 
cation of aerospace remote sensing for agricultural resources, which began in 
fiscal year 1980. This program is a cooperative effort of the National Aero- 
nautics and Space Administration, the U.S. Agency for International Develop- 
ment, and the U.S. Departments of Agriculture, Commerce, and the Interior. 

The work which is the subject of this document was performed within the Earth 
Resources (Research/ Applications) Division, Space and Life Sciences Director- 
ate, at the Lyndon B. Johnson Space Center, National Aeronautics and Space 
Administration. Under Contract NAS 9-15800, personnel of Lockheed Engineering 
and Management Services Company, Inc., performed the tasks which contributed to 
the completion of this research. 
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1. GENERAL INFORMATION 


1.1 SYSTEM NAME 

Winterskill Indtcator Model CCAD Data Base Interface 'Driver Is the name of this 
system. 

1.2 PRIMARY USER 

The primary user of this system Is the U. S. Department of Agriculture (I'SDA), 
Foreign Agriculture Service (FAS), Crop Condition Assessment Division. 

» 

1.3 DEVELOPING ORGANIZATION 

Personnel of Lockheed Engineering and Management Services Company, Inc., 
developed the software that Is reported In this document. 

1.4 COMPUTER FACILITY 

The CCAD computer facility Is equipped with a PDP ii/70 apd the Data Base 
Management System 11 (DBMS 11). 


2. SYSTEM DESCRIPTION 


2.1 PURPOSE 

The purpose of the Winterkill Indicator Model CCAD Data Base Interface Driver 
system Is to Interface the Wlnterk'lll Indicator Model with the CCAD operational 
data base. The Interface driver regulates what meteorological stations should 
be processed and summons the proper subroutines to process the static/is. 

2.2 USAGE 

The system resides on the User Interface System (UIS) processor and must be 
executed on the UIS. The PDS command Is: 

PDS > RUN WNTRKL CR 

The program will then be prepared for Input from the terminal and will issue 
the statement: 
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INPUT YEAR AND OVERRIDE HARDNESS, IF REQUIRED. 

YR H CR 

INPUT RUN DEFINITION CARD.iK'PUT 0 TO STOP. 

The run definition card Is defined In figure 1. To end the run, a 'O' (zero) 
must be Input as an Input card type. 


3. INPUT 

There are two types of Input required: disk and card. 

3.1 DISK 

The model Interfaces with the CCAD data base using the METS2P subschema. The 
format for the data and methods of access are available from the CCAD data base 
administrator. 

3.2 CARD 

Two types of Input cards are required to operate the model, a "year" card and a 
run definition card. The formats for these cards are shown In figures 1 and 2. 

4. PROCESSING 

Figure 3 Is a flow chart of the Winterkill Model execution. 

4.1 INTERACTIVE 

The model Is designed to be operated In an Interactive mode. All error 
messages are displayed on the cathode ray tube (CRT) that Initiated the run and 
will be displayed during the run. The output report, which contains a list of 
the days of Indicated winterkill. Is sent to the line printer Immediately after 
the model run has been completed The procedure for executing the model Is 
presented In paragraph 2.2. 
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ORSGltiW- 

OF POOR QUAUTV 


Hierarchy 10 


Start Stop 

Stop day latitude latitude 



Hierarchy ID: Country only - Process all stations in country. 

Country and region - Process all stations in region. 

Country, region, and zone - Process all stations in zone. 

Country, region, zone, and strata - Process all stations in strata. 
Stop day: Blanks - Process all meteorological data. 

Date - Process meteorological data prior to date. 

Start-stop latitudes: Blanks - Process all stations between 30* and 60°. 

Latitudes - Process stations between input latitudes. 

(a) Rules where code = 1. 


Meteorological station ID 


Stop day 


1 2 3 4 5 6 7 8 9 10 11 12 13 14 16 16 17 18 19 30 21 22 23 24 26 "'OO 




Day 


' — Month 


WMO 

' — Type access 


I Code for 

non-WMO 


‘—Year 


Access by station directly 
(code = 2) 


Meteorological station ID: Station ID - Process only this station. 

Stop day: ' Blanks - Process all meteorological data. 

Date - Process meteorological data prior to date. 


(b) Rules where code * 2. 

Figure 1.- Run definition card formats for codes i and 2, Winterkill Model. 
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First card of the Input deck must be a year card with the following format: 



Figure 2.- Year card format, Winterkill Model. 



Figure 3.- Execution flow diagram. 
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Figure 3.- Concluded 














4.2 BATCH 


The model is not presently configured to run In a batch environment. A simple 
modification to the driver and task builder command file would be required to 
provide a batch capability. 


5. OUTPUT 

This model has two types of outputs! disk and hardcopy. 

5.1 DISK 

For each day of Indicated winterkill, the model creates a STN-WINTERKILL record 
for that day and stores It In the CCAD data base. If the final day of pro- 
cessing for each station does not happen to be a day of Indicated winterkill, 

then a dummy record Is created and stored In the data base to Indicate the date 
of last update, The format for the STN-WINTERKILL record Is available from the 
CCAD data base administrator. 

5.2 HARDCOP Y 

The output report consists of a list of Indicated winterkill days by station. 

Included In each day's report are the station ID; the day's date; the number of 

continuous days of winterkill; the probability of winterkill (percentage) for 
the day; the hardness; and the minimum and maximum temperature, precipitation, 
and snow cover for the day. 

6. SPECIAL INSTRUCTIONS OR RESTRICTIONS 

Use of the Winterkill Model Is subject to a few special Instructions and 
restrictions. 

6.1 LATITUDE 

Use of the Winterkill Model Is restricted to stations betweeen latitude 30® N. 
and latitude 60“ N. Any station whose latitude Is outside this range (Includ- 
ing the entire Southern Hemisphere) will be Ignored. 
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6.2 HARDNESS OVERRIDE 


The capability to override the hardness of a particular station has two 
functions. If an override hardness is input at the beginning of the run, then 
every station that is processed will contain that hardness and further calcu- 
lations will begin using that value. Furthermore, if an override hardness of 0 
(zero) is input, the program will erase all previous STN-WINTERKII.L records and 
begin calculations anew. 

6.3 HARDNESS CALCULATIONS DATA 

A minimum of 2 months of data, starting at the first of October, is required to 
calculate hardness. No hardness calculations should be attempted with the 
model unless it contains at least this minimum amount of data. 


;. REFERENCE 


Information contained in this manual was taken from Winterkill Indicator Model 
documentation, CCAD Software Documentation Library; USDA, FAS; Houston, Texas 
77058. 
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